home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / ar.man < prev    next >
Encoding:
Text File  |  1991-10-04  |  5.8 KB  |  201 lines
  1.  
  2.  
  3.  
  4. AR                        User Commands                        AR
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      ar - archive maintenance
  12.  
  13. SSYYNNOOPPSSIISS
  14.      aarr _f_l_a_g_s [_p_o_s_n_a_m_e] _a_r_c_h_i_v_e [_n_a_m_e _n_a_m_e ...]
  15.  
  16. OOPPTTIIOONNSS
  17.      aa              Position the named files after _p_o_s_n_a_m_e.
  18.  
  19.      bb              Position the named files before _p_o_s_n_a_m_e.
  20.  
  21.      cc              If creating an archive for the first time, do
  22.                     it silently.
  23.  
  24.      dd              Command: delete  the  named  files  from  the
  25.                     archive.
  26.  
  27.      ii              Position the named files before _p_o_s_n_a_m_e.
  28.  
  29.      ll              Ignored.  This flag is kept for compatibility
  30.                     with the UNIX aarr.
  31.  
  32.      mm              Command: move the named files to a  different
  33.                     location in the archive.
  34.  
  35.      oo              When extracting a file from the archive, give
  36.                     it the last-modified time that is recorded in
  37.                     the archive.  The default is to give  it  the
  38.                     current time.
  39.  
  40.      pp              Command: print out the named  files.   If  no
  41.                     files  are  named, print out all files in the
  42.                     archive.
  43.  
  44.      qq              Command: quickly append the  named  files  to
  45.                     the  archive.   If  the  named  files already
  46.                     exist, the archive will end  up  with  dupli-
  47.                     cates.  This command is intended for creating
  48.                     a new archive with lots  of  files  with  one
  49.                     invocation of aarr.
  50.  
  51.      rr              Command:  replace  the  named  files  in  the
  52.                     archive.   If  a  named file isn't already in
  53.                     the archive, it is added.
  54.  
  55.      ss              Create a  ____..SSYYMMDDEEFF  file  for  the  archive.
  56.                     This  flag  may  be used as a command or as a
  57.                     modifier to other commands.
  58.  
  59.      tt              Command: list the named files in the archive.
  60.  
  61.  
  62.  
  63. Sprite v.1.0        Printed:  October 4, 1991                   1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. AR                        User Commands                        AR
  71.  
  72.  
  73.  
  74.                     If  no files are named, the table of contents
  75.                     for the entire archive is listed.
  76.  
  77.      uu              If replacing files, only replace a file if it
  78.                     is  newer than the version in the archive (or
  79.                     if there is no  version  in  the  archive  at
  80.                     all).
  81.  
  82.      vv              Turn on the ``verbose'' flag.
  83.  
  84.      xx              Command: extract the  named  files  from  the
  85.                     archive.   If no files are named, extract all
  86.                     files in the archive.
  87.  
  88. _________________________________________________________________
  89.  
  90.  
  91. DDEESSCCRRIIPPTTIIOONN
  92.      AArr maintains archive files, which are collections  of  other
  93.      files.   An  archive  file  is  usually used as a library of
  94.      object files, for use with lldd.
  95.  
  96.      Each invocation of aarr always takes one command flag  and  an
  97.      archive name.  It may also take modifier flags, which appear
  98.      with the command letter.   For  example,  ttvv  specifies  the
  99.      ``table-of-contents''  command,  with  the  ``verbose'' flag
  100.      turned on.  It is equivalent to vvtt.  If you specify  any  of
  101.      the  aa,  bb,  or  ii flags (for the mm or rr commands), you must
  102.      also specify _p_o_s_n_a_m_e, which is the name of  a  file  in  the
  103.      archive  that  other  files  will be positioned relative to.
  104.      The default is to place the files at the end of the archive.
  105.      Finally,  most commands require that you specify one or more
  106.      file names.  These names refer  to  files  in  the  archive,
  107.      files  outside  the  archive, or both, depending on the com-
  108.      mand.
  109.  
  110.      You may specify a complete path for any file name.  AArr  will
  111.      remove  leading  path information and truncate the file name
  112.      to 15 characters to get the name of the file as it is stored
  113.      in  the  archive.  However, the full given path will be used
  114.      when referring to files outside the archive for  the  qq,  rr,
  115.      and xx commands.
  116.  
  117.      Some UNIX linkers require that an object file library have a
  118.      ____..SSYYMMDDEEFF  file,  which  contains  a  string  table that the
  119.      linker lldd uses to resolve external references.  This version
  120.      of  aarr  maintains  the ____..SSYYMMDDEEFF file automatically, once it
  121.      exists, and it will create the ____..SSYYMMDDEEFF file if the ss  flag
  122.      is  specified.   Thus,  rraannlliibb, which is the program usually
  123.      used to maintain the ____..SSYYMMDDEEFF file, is not needed with this
  124.      version of aarr.
  125.  
  126.      The vv flag has a varied effect,  depending  on  the  command
  127.      involved.   For  most commands, specifying the vv flag merely
  128.  
  129.  
  130.  
  131. Sprite v.1.0        Printed:  October 4, 1991                   2
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138. AR                        User Commands                        AR
  139.  
  140.  
  141.  
  142.      causes aarr to tell you what it's doing as it  does  it.   For
  143.      the tt command, the vv flag causes information about each file
  144.      (other than just its name) to be printed.   This  additional
  145.      information consists of
  146.  
  147.      o+    the permissions associated with the file (as displayed by
  148.           llss)
  149.  
  150.      o+    the file's owner and group (displayed as integers)
  151.  
  152.      o+    the file's length in bytes
  153.  
  154.      o+    the last-modified time of the file
  155.  
  156.  
  157. SSEEEE AALLSSOO
  158.      ranlib, ld, ls
  159.  
  160.  
  161. KKEEYYWWOORRDDSS
  162.      archive, library
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197. Sprite v.1.0        Printed:  October 4, 1991                   3
  198.  
  199.  
  200.  
  201.